Microsoft¿ Personal Web Server for Macintosh 1.0a¿
Welcome!
Microsoft Personal Web Server is a full-featured Web server designed to run in the background on your desktop Macintosh. Best of all, it's easy to use! Everything you need to monitor your Web site and personalize your home page is available from the Microsoft Personal Web Server control panel. In addition, as owner of the Web server, you can use the site administration tools available when you view your home page from Internet Explorer. These tools let you do things such as read messages, and browse and retrieve files from your disk. If you don't know HTML, don't worry. Microsoft Personal Web Server will automatically convert SimpleText documents.
Requirements
Ñ Macintosh (68030 or 68040), Power Macintosh, or comparable MacOS compatible computer with at least 8 megabytes of memory (RAM) installed.
Ñ 1.2 MB of available memory (RAM).
Ñ MacOS System 7.1 or later.
Ñ 2 MB of hard disk space.
If you have a 68k Macintosh:
Ñ If you are running less than System 7.5 on a 68k machine, you'll need Thread Manager 2.0 (the installer will automatically place this in the Extensions folder in your System folder)
Access to the Internet
You must have access to the Internet through an Internet service provider or the network to which your computer is connected. To take full advantage of Personal Web Server, you must also have a static IP address or domain name.
Internet Software
Ñ MacTCP (Control Panel)
If you are a dial-up user, Config PPP connection software (Control Panel) with PPP (Extension)
For help with Microsoft Personal Web Server for Macintosh, open the Microsoft Personal Web Server control panel and choose Personal Web Server Help from the "?" menu.
Join the PWS for Macintosh newsgroup
Interact with other users Microsoft Personal Web Server for Macintosh by accessing microsoft.public.internet.personwebserv.mac. Please visit the Technical Support Newsgroup page at http://www.microsoft.com/support/news/ to review rules of conduct.
Reporting Problems
To report bugs, send mail to PWSMBugs@microsoft.com.
Include
Ñ System configuration information (on the Apple menu, choose About Personal Web Server, and then click Support)
Version of operating system
Type of Macintosh
Type of connection to the Internet
Ñ Steps that lead to the bug. For example:
1. Open the Microsoft Personal Web Server control panel.
2. Click the Links button.
3. Add links to your home page.
4. View your home page and no links appear.
Ñ Any other information that will help us reproduce the bug successfully.
Although you will not receive a response via e-mail, all bug reports will be read and evaluated by a Quality Assurance Engineer. Thank you for your help.
Technical Support
Microsoft offers 90 days of product support at (206) 635-7123 in the US and (905) 568-4494 in Canada. This support is free of charge, except for the cost of the telephone call.
Registering Microsoft Personal Web Server 1.0a for Macintosh
Register Microsoft Personal Web Server 1.0a free of charge at http://www.microsoft.com/ie/ie_reg.htm. If you have already registered PWS version 1.0, you do not need to register this release.
For more information, see the License Agreement document. You can use the index in the online Help to access the License Agreement. To do so, use the keyword "agreement."
CGI and AppleEvent Support
Microsoft Personal Web Server for Macintosh has improved support for AppleEvents and CGIs.
Ñ PWS now supports AppleEvents to control the server from a remote application.
Ñ CGIs can now register themselves as action CGIs. The supported actions are Preprocessor, Postprocessor, and Normal.
Ñ Remote applications can now register themselves with the server to receive request logging information and server status information.
Accessing your Web site
Your Web site can be accessed with any browser. However, when you, and visitors to your Web site use Internet Explorer, your Web pages will look their best. Internet Explorer lets you take advantage of some of the latest HTML features such as style sheets and frames. For more information on HTML, visit http://www.microsoft.com/workshop/author/newhtml, or to download a free copy of Internet Explorer for the Macintosh, visit http://www.microsoft.com/ie/mac.
Active Server Pages
The ASP syntax has been modified and finalized since the beta release of PWS. Some of the tags used in the default documents in the beta version of the My Personal Web Site folder may continue to work with Personal Web Server 1.0. However, this syntax may not be supported in future versions.
For information on using Active Server Pages with Microsoft Personal Web Server for Macintosh, open the Microsoft Personal Web Server control panel and then choose Microsoft Personal Web Server Help from the "?" menu.
My Personal Web Site
The documents that Personal Web Server Installer places in the My Personal Web Site folder make it easy to get your first Web site up and running. These documents use Active Server Pages to create a dynamic home page, including a simple message area and guestbook. To learn more about Active Server Pages, refer to Personal Web Server Help.
Note: If you already have an earlier version of the My Personal Web Site folder when you run the 1.0a version of Personal Web Server Installer, the installer places updated versions of these documents in a Personal Web Site Files 1.0a folder in the Personal Web Server subfolder in the Microsoft Internet Applications folder.
Known Problems with Microsoft Personal Web Server 1.0a
Slash ("/") not permitted in hard disk, file, or folder names: The slash character is used in URLs to separate folders in a path. If this character is included within a published disk, file, or folder name, Personal Web Server will misinterpret the name and will be unable to serve up the item or any files or folders it contains.
Under MacTCP, dial-up PPP connections may not be initiated: With some PPP programs under MacTCP, Personal Web Server may fail to initiate a dial-up connection. If you experience this problem, manually establish the dial-up PPP connection before turning Web publishing on. Once the connection is established, Personal Web Server should function properly.
JIS encoding in HTML documents: HTML documents encoded with the JIS character set may not display properly when served up by Personal Web Server because Personal Web Server removes all occurrences of "<%" when processing HTML for Active Server Pages tags. To prevent Personal Web Server from processing JIS encoded HTML documents, use the ".jis" file extension instead of ".html".
FTP Plug-in may be slow on 68K computers: On 68K computers, the FTP Plug-in may be slow to respond when the client does not have permission to access the requested item. When this happens the 68K computer running Personal Web Server may not respond to user input for up to 15 seconds.
Personal Web Server may not have enough memory for certain plug-ins: Because Personal Web Server uses very little memory (RAM), it may not have enough memory available to run certain plug-ins. Every plug-in you place in the Server Plug-ins folder uses some of the memory available to Personal Web Server.
My Personal Web Site from Microsoft Personal Web Server 1.0b1: Due to changes in the Active Server Pages syntax, the message and guestbook links on the home page included with Personal Web Server 1.0b1 no longer work with Personal Web Server 1.0 and the home page may display extra content.
Personal Web Server supports fewer connections on a 68K Macintosh: Because of memory limitations, Personal Web Server supports fewer connections on 68K computers.
When using the W*API Adapter Plug-in and certain W*API plug-ins on 68K Macintosh computers, stopping the server may cause a crash. The W*API version of CountWWWebula is known to exhibit this problem. A MOS plug-in version of CountWWWeblua is available and will not cause this crash.
Upgrading from Microsoft Personal Web Server 1.0
The documents in the My Personal Web Site folder have been updated. If you have an earlier version of this folder, the Personal Web Server Installer does not automatically update it, but it places the updated versions in a Personal Web Site Files 1.0a folder in the Personal Web Server subfolder in the Microsoft Internet Applications folder.
The changes to the documents in the My Personal Web Site folder are mostly cosmetic. If you are currently using the 1.0 versions of these files, they will continue to function normally. If prefer the updated pages, you can either replace or manually update the older versions of these documents. You may loose your Guestbook entries and messages however. Note that the hierarchy of the My Personal Web Site folder has been changed and that the names of several of the documents have been modified by replacing the ".htm" extension with ".asp".
Major Changes since 1.0
Improved Web Site: The new documents in the "My Personal Web Site" folder provide a more attractive Web site and add extra links, including a link to a shared documents folder.
Easier to Use: Some terminology and functionality in the user interface has been refined to make Personal Web Server easier to use.
Improved CGI and Plug-in support: Personal Web Server CGI and plug-in support has been further enhanced to support a broader range of third party server extensions.
Improved Help files: The updated Help files provide more details about using Microsoft Personal Web Server.
Upgrading from Microsoft Personal Web Server 1.0b1
The documents in the My Personal Web Site folder have been updated. If you have an earlier version of this folder, the Personal Web Server Installer does not automatically update it, but it places the updated versions in a Personal Web Site Files 1.0 folder in the Personal Web Server subfolder in the Microsoft Internet Applications folder. The beta versions of these documents will no longer work properly because the Active Server Pages tags are significantly different in the new versions. You can either replace or manually update the older versions of these documents. Note that the hierarchy of the My Personal Web Site folder has been changed and that the names of several of the documents have been modified by replacing the ".htm" extension with ".asp".
Major Changes since 1.0b1
FTP Plug-in fixes: The FTP Plug-in now works on 68K and PPC Macintosh computers. Other problems have also been resolved, including access control and FTP client compatibility issues.
Active Server Pages: The syntax of the Personal Web Server Active Server Pages implementation has been changed to make it more compatible with Internet Information Server. Active Server Pages are now documented in Personal Web Server Help.
CGI, AppleEvent, and MOS Plug-in support: Personal Web Server CGI and MOS plug-in support has been enhanced to support a broader range of third party server extensions.
W*API¬ plug-in support: Personal Web Server now ships with a beta version of the W*API¬ Adapter Plug-in that allows Personal Web Server to use W*API¬ plug-ins.
Log format: The Personal Web Server Log format now places the date and time in separate fields.
My Personal Web Site: The contents of the My Personal Web Site folder have been updated to use the new Active Server Pages syntax. Files that use Active Server Pages are now identified by the ".asp" file extension. (Because of these changes, several tags supported in Personal Web Server 1.0b1 may not work properly in 1.0.)
Attention Web for One¬ users!
Microsoft Personal Web Server is similar to Web for One, but has some important differences. Because of these differences, Web for One users will have to manually switch to Microsoft Personal Web Server. This document explains the differences between the two servers and provides instructions for switching from Web for One to Microsoft Personal Web Server.
Changes:
Ñ Improved Performance: Microsoft Personal Web Server has notable speed improvements over Web for One. (This performance enhancement was achieved with a small increase in the memory used by the Web server-it still uses close to one megabyte of RAM.)
Ñ MOS Plug-in Support: Personal Web Server supports MOS plug-ins. To install a MOS plug-in, drop the plug-in into the Server Plug-ins folder. This folder is located in the PWS folder in MS Internet inside your System folder. To make installing plug-ins easy, the installer places an alias to the Server Plug-ins folder in the Personal Web Server folder.
Ñ Active Server Pages: Active Server Pages (ASP) allows you to create dynamic Web pages and forms using a scripting language based on VBScript. The ASP syntax replaces the syntax used by Web for One for server includes and form processing. Because Microsoft Personal Web Server does not support the Web for One server include or form processing syntax, all pages using that syntax will have to be updated. (This version of Microsoft Personal Web Server for Macintosh does not support the full ASP scripting language, but does provide equivalent functionality to the server includes and form processing syntax used in Web for One.)
Ñ The default pages installed by Web for One contain old versions of the 'server include' and 'form processing' syntax. The Microsoft Personal Web Server installer places updated versions of these documents in a new Web site folder, called My Personal Web Site. If you made changes to the original default pages, you will have to manually update these pages again.
Ñ Preferences: Microsoft Personal Web Server will not retain your previous Web for One settings. Please use the Microsoft Personal Web Server control panel to configure your Web server again.
Switching from Web for One to Microsoft Personal Web Server:
If you have been using Web for One, you will have to make a number of changes to begin using Microsoft Personal Web Server.
To switch from Web for One to Microsoft Personal Web Server:
1. Install Microsoft Personal Web Server.
This installation will not affect Web for One. Web for One will continue to publish your Web site, until you manually switch to Microsoft Personal Web Server, as described in this section.
2. Open the Microsoft Personal Web Server control panel.
3. Configure the server options, and re-enter information in the About Me and Links panels. Do not click the Start button yet.
The Microsoft Personal Web Server installer places a new default Web site on your hard disk. If you want to continue to use your original Web site folder, click Set Folder... and select that folder.
4. Update your Web site folder.
Personal Web Server does not support the server include and form processing syntax used by Web for One. The "My Personal Web Site" folder installed with Personal Web Server contains updated versions of the default pages installed with Web for One.
If you continue to publish the folder you published with Web for One, replace the default pages installed with Web for One with those from the "My Personal Web Site" folder. If you modified these default pages or have other pages on your site that use the old syntax, you must update those pages to use the ASP syntax.
If you elect to publish the new "My Personal Web Site" folder, make sure to copy over any files from your original Web site folder that you want to publish.
5. Turn off and remove Web for One.
To do this, open the Web for One control panel, and if Web publishing is on, click Stop. Then, close the control panel and remove Web for One from the Control Panels folder. Finally, open the Extensions folder, located inside your System Folder, and remove the Web for One Extension. (You may save the control panel and extension outside the System folder, or drag them into the Trash.)
6. Click Start in the Microsoft Personal Web Server control panel to begin publishing your Web site again.
